home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / pmval.z / pmval
Text File  |  1998-10-20  |  10KB  |  233 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMVVVVAAAALLLL((((1111))))                                                              PPPPMMMMVVVVAAAALLLL((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmvvvvaaaallll - performance metrics value dumper
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmvvvvaaaallll [----ddddggggrrrrzzzz] [----AAAA _a_l_i_g_n] [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t] [----iiii _i_n_s_t_a_n_c_e_s] [----nnnn
  13.      _p_m_n_s_f_i_l_e] [----OOOO _o_f_f_s_e_t] [----pppp _p_o_r_t] [----SSSS _s_t_a_r_t_t_i_m_e] [----ssss _s_a_m_p_l_e_s] [----TTTT _e_n_d_t_i_m_e]
  14.      [----tttt _i_n_t_e_r_v_a_l] [----wwww _w_i_d_t_h] [----ZZZZ _t_i_m_e_z_o_n_e] _m_e_t_r_i_c_n_a_m_e
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      ppppmmmmvvvvaaaallll prints current or archived values for the nominated performance
  18.      metric.  The metric of interest is named in the _m_e_t_r_i_c_n_a_m_e argument,
  19.      subject to instance qualification with the ----iiii flag as described below.
  20.  
  21.      Unless directed to another host by the ----hhhh option, or to an archive by the
  22.      ----aaaa option, ppppmmmmvvvvaaaallll will contact the Performance Metrics Collector Daemon
  23.      (PMCD) on the local host to obtain the required information.
  24.  
  25.      When processing an archive, ppppmmmmvvvvaaaallll may relinquish its own timing control,
  26.      and operate as a ``slave'' of a ppppmmmmttttiiiimmmmeeee(1) process that uses a GUI dialog
  27.      to provide timing control.  In this case, either the ----gggg option should be
  28.      used to start ppppmmmmvvvvaaaallll as the sole slave of a new ppppmmmmttttiiiimmmmeeee(1) instances, or ----pppp
  29.      should be used to attach ppppmmmmvvvvaaaallll to an existing ppppmmmmttttiiiimmmmeeee(1) instance via the
  30.      IPC channel identified by the _p_o_r_t argument.
  31.  
  32.      The ----SSSS, ----TTTT, ----OOOO and ----AAAA options may be used to define a time window to
  33.      restrict the samples retrieved, set an initial origin within the time
  34.      window, or specify a ``natural'' alignment of the sample times; refer to
  35.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1) for a complete description of these options.
  36.  
  37.      Options which control the source, timing and layout of the information
  38.      reported by ppppmmmmvvvvaaaallll are as follows:
  39.  
  40.      ----aaaa   Performance metric values are retrieved from the Performance Co-
  41.           Pilot (PCP) archive log file identified by the base name _a_r_c_h_i_v_e.
  42.  
  43.      ----dddd   When replaying from an archive, this option requests that the
  44.           prevailing real-time delay be applied between samples (see ----tttt) to
  45.           effect a pause, rather than the default behaviour of replaying at
  46.           full speed.
  47.  
  48.      ----gggg   Start ppppmmmmvvvvaaaallll as the slave of a new ppppmmmmttttiiiimmmmeeee(1) process for replay of
  49.           archived performance data using the ppppmmmmttttiiiimmmmeeee(1) graphical user
  50.           interface.
  51.  
  52.      ----hhhh   Current performance metric values are retrieved from the nominated
  53.           _h_o_s_t machine.
  54.  
  55.      ----iiii   _i_n_s_t_a_n_c_e_s is a list of one or more instance names for the nominated
  56.           performance metric - just these instances will be retrieved and
  57.           reported (the default is to report all instances).  The list must be
  58.           a single argument, with elements of the list separated by commas
  59.           and/or white space.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMVVVVAAAALLLL((((1111))))                                                              PPPPMMMMVVVVAAAALLLL((((1111))))
  71.  
  72.  
  73.  
  74.      ----nnnn   Normally ppppmmmmvvvvaaaallll operates on the default Performance Metrics Name
  75.           Space (PMNS), however if the ----nnnn option is specified an alternative
  76.           namespace is loaded from the file _p_m_n_s_f_i_l_e.
  77.  
  78.      ----pppp   Attach ppppmmmmvvvvaaaallll to an existing ppppmmmmttttiiiimmmmeeee(1) time control process instance
  79.           via the IPC channel identified by the _p_o_r_t argument.  This option is
  80.           normally only used by other tools, e.g.  ppppmmmmvvvviiiieeeewwww(1), when they launch
  81.           ppppmmmmvvvvaaaallll with synchronized time control.
  82.  
  83.      ----rrrr   Print raw values for cumulative counter metrics.  Normally
  84.           cumulative counter metrics are converted to rates.  For example,
  85.           disk transfers are reported as number of disk transfers per second
  86.           during the preceding sample interval, rather than the raw value of
  87.           number of disk transfers since the machine was booted.  If you
  88.           specify this option, the raw metric values are printed.
  89.  
  90.      ----ssss   The argument _s_a_m_p_l_e_s defines the number of samples to be retrieved
  91.           and reported.  If _s_a_m_p_l_e_s is 0 or ----ssss is not specified, ppppmmmmvvvvaaaallll will
  92.           sample and report continuously (in real time mode) or until the end
  93.           of the PCP archive (in archive mode).
  94.  
  95.      ----tttt   The default update _i_n_t_e_r_v_a_l may be set to something other than the
  96.           default 1 second.  The _i_n_t_e_r_v_a_l argument follows the syntax
  97.           described in PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), and in the simplest form may be an
  98.           unsigned integer (the implied units in this case are seconds).
  99.  
  100.      ----wwww   Set the width of each column of output to be _w_i_d_t_h columns.  If not
  101.           specified columns are wide enough to accommodate the largest value
  102.           of the type being printed.
  103.  
  104.      ----ZZZZ   By default, ppppmmmmvvvvaaaallll reports the time of day according to the local
  105.           timezone on the system where ppppmmmmvvvvaaaallll is run.  The ----ZZZZ option changes
  106.           the timezone to _t_i_m_e_z_o_n_e in the format of the environment variable
  107.           TTTTZZZZ as described in eeeennnnvvvviiiirrrroooonnnn(5).
  108.  
  109.      ----zzzz   Change the reporting timezone to the local timezone at the host that
  110.           is the source of the performance metrics, as identified via either
  111.           the ----hhhh or ----aaaa options.
  112.  
  113.      The following symbols may occasionally appear, in place of a metric
  114.      value, in ppppmmmmvvvvaaaallll output:  A question mark symbol (?) indicates that a
  115.      value is no longer available for that metric instance.  An exclamation
  116.      mark (!)  indicates that a 64-bit counter wrapped during the sample.
  117.  
  118.      The output from ppppmmmmvvvvaaaallll is directed to standard output.
  119.  
  120. FFFFIIIILLLLEEEESSSS
  121.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////*         default PMNS specification files
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMVVVVAAAALLLL((((1111))))                                                              PPPPMMMMVVVVAAAALLLL((((1111))))
  137.  
  138.  
  139.  
  140. SEE ALSO
  141.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), ppppmmmmccccdddd(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmiiiinnnnffffoooo(1), ppppmmmmllllooooggggggggeeeerrrr(1)
  142.      and ppppmmmmttttiiiimmmmeeee(1).
  143.  
  144. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  145.      All are generated on standard error and are intended to be self-
  146.      explanatory.
  147.  
  148. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  149.      ppppmmmmvvvvaaaallll attempts to display non-integer numeric values in a way that does
  150.      not distort the inherent precision (rarely more than 4 significant
  151.      digits), and tries to maintain a tabular format in the output.  These
  152.      goals are sometimes in conflict.
  153.  
  154.      The following table describes the formats used for different ranges of
  155.      numeric values for any metric that is of type PPPPMMMM____TTTTYYYYPPPPEEEE____FFFFLLLLOOOOAAAATTTT or
  156.      PPPPMMMM____TTTTYYYYPPPPEEEE____DDDDOOOOUUUUBBBBLLLLEEEE, or any metric that has the semantics of a counter (for
  157.      which ppppmmmmvvvvaaaallll reports the rate converted value):
  158.                         __________________________________
  159.                           Format         Value Range
  160.                         __________________________________
  161.                                  !   No values available
  162.                          9.999E-99   < 0.1
  163.                             0.0      0
  164.                             9.9999   > 0 and <= 0.9999
  165.                             9.999    > 0.9999 and < 9.999
  166.                            99.99     > 9.999 and < 99.99
  167.                           999.9      > 99.99 and < 999.9
  168.                          9999.       > 999.9 and < 9999
  169.                          9.999E+99   > 9999
  170.                         __________________________________
  171.                         ||||||||||||
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.                                    ||||||||||||
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.                                                           ||||||||||||
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.                                                                         PPPPaaaaggggeeee 3333
  230.  
  231.  
  232.  
  233.